home *** CD-ROM | disk | FTP | other *** search
/ CD ROM Paradise Collection 4 / CD ROM Paradise Collection 4 1995 Nov.iso / dskutil / colrboot.zip / COLRBOOT.DOC < prev    next >
Text File  |  1994-10-29  |  22KB  |  465 lines
  1.  
  2.  
  3.            ┌───┐      JIM TUCKER ■ SOFTWARE
  4.          ┌─┴─┐ ├──┐   4/635 Brighton Road
  5.          │  ┌┴─┴┐ │   Seacliff
  6.          └──┤   ├─┘   South AUSTRALIA 5051
  7.             └───┘     ═════════════════════════════════════════════════
  8.  
  9.                       Phone 61 8 377 1175
  10.                       jtucker@adam.com.au
  11.                       JIM TUCKER 3:800/805           29 October 1994
  12.  
  13.  
  14.        ■ Copyright (c) 1994 JIM TUCKER. All rights reserved
  15.  
  16.        THIS IS a complete unrestricted version of COLOR BOOT. You may 
  17.        use it and distribute it freely without restriction provided no 
  18.        charge is made and no changes are made to the program or this 
  19.        documentation. You may distribute disks with COLOR BOOT screens. 
  20.        You may also bundle this program with any software you sell 
  21.        provided you supply all files unchanged (including the source
  22.        code). You must also mention that it is supplied as a separate
  23.        program and requires separate (optional) registration.
  24.  
  25.        | By default COLRBOOT displays an "UNREGISTERED" message. This 
  26.        | can be DISABLED WITHOUT REGISTRATION. See the end of this 
  27.        | document for information and incentives.
  28.  
  29.        The manifest of files supplied is included in the README file.
  30.        The usual disclaimers apply.
  31.  
  32.        ───────────────────────────────────────────────────────────────-
  33.        ABOUT THIS PROGRAM
  34.        ───────────────────────────────────────────────────────────────-
  35.  
  36.        COLRBOOT.COM is a DOS utility which lets you to write a color
  37.        message on a non-system diskette. Your message will display when
  38.        a user tries to boot from the disk.
  39.  
  40.        Disks can be distributed with the simple message: "Boot Me" and 
  41.        explicit directions can be displayed on the screen or a complete 
  42.        ASCII color screen can be displayed. Optionally, the target disk
  43.        can be set to boot directly from a hard disk with no display.
  44.  
  45.        For a quick demonstration:
  46.  
  47.           ■ COPY the files on this disk to your hard disk
  48.           ■ Insert a *blank formatted* Non-System disk in Drive A
  49.           ■ Enter COLRBOOT COLRDEMO.BIN A:
  50.           ■ Now "boot" from the Drive A disk
  51.  
  52.        | IMPORTANT NOTE: COLRBOOT WILL TARGET ONLY DRIVES A OR B. IT WILL
  53.        | NOT WRITE TO A HARD DISK OR A DISKETTE WHICH CONTAINS THE DOS
  54.        | SYSTEM FILES IBMBIO.COM or IO.SYS.
  55.  
  56.        For a quick preview of the COLOR BOOT screens run the batch file
  57.        V.BAT. If you want to see the filenames displayed enter V /F.
  58.  
  59.        This manual is in FOUR sections.
  60.  
  61.          Section One:   How to copy a color screen on to a target disk.
  62.          Section Two:   How to include your text in the boot display.
  63.          Section Three: Describes several switch options.
  64.          Section Four:  Miscellaneous and incentives.
  65.  
  66.        ───────────────────────────────────────────────────────────────-
  67.        SECTION ONE:
  68.        MAKING A SIMPLE COLOR BOOT DISK
  69.        ───────────────────────────────────────────────────────────────-
  70.  
  71.        The full syntax for COLOR BOOT is:
  72.  
  73.          COLRBOOT [filename|nofile|autoboot|blank] [textfile|grid] [d:]
  74.                   [/pnn] [/cnn] [/tnn] [/r] [/f]
  75.  
  76.        If you are not familiar with this sort of thing do not fret, this 
  77.        manual will take you through all the steps and options. We will 
  78.        start with three simple options which is all you need to know to 
  79.        make your first COLRBOOT disk.
  80.        
  81.        ■ OPTION 1: COLRBOOT
  82.                    ~~~~~~~~
  83.        If no filename is specified COLRBOOT will display a help screen. 
  84.        Simple.
  85.  
  86.        ■ OPTION 2: COLRBOOT FILENAME.BIN
  87.                    ~~~~~~~~~~~~~~~~~~~~~
  88.        If no target drive is specified COLRBOOT will simply display the 
  89.        file and the following prompt:
  90.        
  91.            Boot from hard disk (Y/N)?
  92.            Non-System disk. Replace and
  93.            press any key when ready
  94.  
  95.        The three-line prompt you see is internal to the boot sector and
  96.        NOT part of the file.  What you see is what will display when
  97.        the disk is "booted."  This option provides a convenient way to
  98.        view the screen files supplied with COLRBOOT. (Hint: Use V.BAT to 
  99.        cycle through the screens provided).
  100.  
  101.        ■ OPTION 3: COLRBOOT FILENAME.BIN A: (or B:)
  102.                    ~~~~~~~~~~~~~~~~~~~~~~~~
  103.        Specifying a "target drive" creates a COLOR BOOT disk. COLOR BOOT 
  104.        will write the file to the target disk and create a new boot 
  105.        sector. When the disk is "booted" it will display the file and 
  106.        the prompt "Boot from hard disk (Y/N)?".
  107.  
  108.        Drive B is also a valid target drive. This means that if you have 
  109.        two floppy drives, you can make COLOR BOOT disks of different 
  110.        sizes.
  111.  
  112.        The target diskette may be any standard DOS size: 5¼- inch 360K
  113.        or 1.2M or 3½-inch 720K or 1.44M.
  114.  
  115.        And that's all you need to know to begin making disks which
  116.        display a colorful messages when trying to boot off a
  117.        non-system disk.
  118.  
  119.        V.BAT is a simple batch file which displays all of the ".BIN" 
  120.        files in the current directory. 
  121.  
  122.        Remember, if you do not specify a target drive the output goes to
  123.        the screen. As soon as you specify a drive (A: or B:) you make a
  124.        COLOR BOOT disk.
  125.  
  126.        TWO MORE SIMPLE OPTIONS
  127.        ~~~~~~~~~~~~~~~~~~~~~~~    
  128.  
  129.        ■ COLRBOOT NOFILE A:
  130.          ~~~~~~~~~~~~~~~~~~
  131.        You enter the word "NOFILE" instead of a filename. The boot 
  132.        sector on the target disk is modified but no data is written to 
  133.        the disk. Only the prompt(s) will display. You can use this 
  134.        safely on Non-System disks which contain data as only the boot 
  135.        sector is modified.
  136.  
  137.        ■ COLRBOOT AUTOBOOT A:
  138.          ~~~~~~~~~~~~~~~~~~~~
  139.        You enter the word "AUTOBOOT" instead of a filename. The boot 
  140.        sector is modified but no data is written to the disk. You can 
  141.        use this safely on disks which contain data as only the boot 
  142.        sector is modified. The target disk will automatically boot from 
  143.        the hard disk with no prompt if a hard disk is detected. If there 
  144.        is no hard disk the user will be prompted to replace the disk. 
  145.        This is similar to other BOOT2C utilities.
  146.  
  147.        In summary: COLRBOOT NOFILE will display the "Boot from hard
  148.        disk?" question. COLRBOOT AUTOBOOT will skip the question if the
  149.        user has a hard disk.
  150.  
  151.        THE COLOR FILE
  152.  
  153.        The color file must be a screen binary file, exactly 4000 bytes.
  154.        It may be named anything. I use ".BIN" here for clarity. The file
  155.        may be created with an ANSI editor and saved using a screen save
  156.        utility. COLOR BOOT will not load the file unless it is precisely
  157.        4000 bytes. (See LAUGHING DOG below for more information).
  158.  
  159.        The actual color message should occupy lines 1-21 only. The boot
  160.        prompt, internal to COLRBOOT, defaults to LINE 22 and is 30 
  161.        characters wide. This can be changed (see below).
  162.  
  163.        FORMAT INFORMATION
  164.  
  165.        The color screen is written to the last eight sectors (4K) of the
  166.        target disk. On a disk with 4K available space these sectors are
  167.        usually free, however if the disk has been filled and files have
  168.        been deleted a current file may still occupy this space.
  169.  
  170.        When DOS formats a disk it writes bytes F6 hex to the data
  171.        sectors. COLORBOOT checks for this and will warn you if the target
  172.        sector is not F6F6.  The following message will be displayed:
  173.    
  174.          "WARNING! Message sector may contain data. Continue (Y/N)?"
  175.    
  176.        Since the DOS "delete" or "erase" commands simply mark files
  177.        as being available for reuse (and do not wipe out the contents
  178.        of files), it is possible that the boot sector contains old
  179.        or invalid data.  COLORBOOT displays a warning message just in
  180.        case you want to reinspect the disk's contents.
  181.  
  182.        If the disk contains no files you can continue safely. You will
  183.        also get this message from a diskette which has no files but
  184.        contains a COLRBOOT message.
  185.  
  186.        WRITING TO COLRBOOT DISKS
  187.  
  188.        Your boot message will remain on the disk until DOS subsequently
  189.        writes over it. As the message is at the "very end" of the disk
  190.        this will happen only if the disk is entirely filled. In this
  191.        case nothing except the prompts will display. COLRBOOT will not
  192.        display the "binary color file"
  193.  
  194.        IMPORTANT NOTE: The DOS FORMAT command with no parameters (such 
  195.        as /U) does not write F6 hex bytes to a disk. It simply clears 
  196.        the File Allocation Table (FAT) and directory and leaves the data 
  197.        on the disk so that UNFORMAT can restore it. If you see a warning 
  198.        that the sector may contain data but you have no files you may 
  199.        safely ignore the warning.
  200.  
  201.        Do not use a so-called "pre-formatted" disk without first 
  202.        formatting them using DOS. Pre-formatted disks contain nothing 
  203.        useful in the boot sector. If you try to boot from some I
  204.        have examined you do not get a message... just a locked up
  205.        computer. This may make no difference when the disk is used for
  206.        data but if the disk is accidently left in Drive A the PC will
  207.        halt at the next boot. This can be disconcerting.
  208.  
  209.        Whether you use COLOR BOOT or not, for safety's sake never use a
  210.        pre-formatted disk without doing an unconditional format using 
  211.        the /U option. For example: FORMAT A: /U
  212.  
  213.        You cannot use the DOS "sys" command to copy DOS system files and
  214.        COMMAND.COM onto a COLRBOOT disk.  This is because the boot 
  215.        sector which searches for IO.SYS or IBMBIO.COM file is modified.
  216.  
  217.        Finally, do NOT use a public domain or shareware FORMAT program.
  218.        Most of them get it wrong. Not all PCs look for a disk in drive A
  219.        when booted. Some BIOS ROMs can be set to boot from Drive C.
  220.  
  221.        ───────────────────────────────────────────────────────────────-
  222.        SECTION TWO:
  223.        ADDING TEXT TO A COLOR SCREEN
  224.        ───────────────────────────────────────────────────────────────-
  225.  
  226.        In the following examples I have not specified a target drive.
  227.        Simply include it to write to the disk or leave it out to preview
  228.        what you are doing. All filenames may be preceded by a path.
  229.  
  230.        If a text filename is specified on the command line the text will
  231.        OVERLAY the color image. This important option lets you add your
  232.        own message to any of the color screens supplied.
  233.  
  234.        The "boot" screen can consist of any of the screens supplied plus
  235.        your text, or you can use the whole screen for your text. You may
  236.        also substitute the COLOR BOOT prompt for your own.
  237.  
  238.        To include text the name of the color image file must be
  239.        specified first, followed by the name of the text file, Thus:
  240.        COLRBOOT COLRFILE.BIN YOURFILE.TXT creates a boot disk containing 
  241.        both the color ".BIN" file and your text overlayed on the image.
  242.  
  243.        The text file can be any ASCII file written with a vanilla word
  244.        processor. The text is written OVER the image. All characters on
  245.        a line, including spaces, will overwrite the underlying image. It
  246.        helps here if you use a text editor which will display end of
  247.        line codes (return). All spaces before the return write over the
  248.        screen.
  249.  
  250.        The underscore character (ASCII 95) can be used in the text file
  251.        to indicate a blank in a line but leave the underlying image
  252.        undisturbed. You can therefore use the underscore to position
  253.        text across the screen and still keep the underlying color screen
  254.        intact. Example:
  255.  
  256.        _____________________________ This is my text over here
  257.        The color screen remains here
  258.  
  259.        The text file must not exceed 2000 bytes. Lines after 25 will be
  260.        ignored and may be used for comment. Note that lines 22, 23 and
  261.        24 are the default for the boot prompt. Do not write to these
  262.        lines left of Column 30. Your message will be bombed by the
  263.        prompt unless you use the /P switch.
  264.  
  265.        WRITING TEXT ONLY
  266.  
  267.        If you would like a message displayed but no color file specify 
  268.        BLANK as the color filename. Thus: COLRBOOT BLANK MYFILE.TXT 
  269.        places your text file on a blank background. (You may choose the 
  270.        color for your text, see below).
  271.  
  272.        BLANK is an option recognized by COLRBOOT; it is not a filename.
  273.        The word simply tells COLRBOOT to use a blank screen. This is NOT 
  274.        the same as NOFILE which writes nothing to the disk except the 
  275.        boot sector. If you want nothing use NOFILE. If you want nothing 
  276.        with text use BLANK then the name of your text file.
  277.  
  278.        WHERE TO PUT TEXT
  279.  
  280.        You may calculate where to put your text over a color screen
  281.        using the built in grid. It is easier to see it than describe it.
  282.        Use "GRID" as the dummy filename: COLRBOOT COLRFILE.BIN GRID 
  283.        (with no drive specified).
  284.  
  285.        This will show you where to position your characters in the text
  286.        file so they do not overwrite portions of the color screen.
  287.        You may use the Print Screen key to print the image and the grid 
  288.        before writing your text file.
  289.  
  290.        ───────────────────────────────────────────────────────────────-
  291.        SECTION THREE:
  292.        COMMAND LINE SWITCHES
  293.        ───────────────────────────────────────────────────────────────-
  294.  
  295.        COLRBOOT has several switches which you may key on the command 
  296.        line when making a COLOR BOOT disk. Here is a summary:
  297.  
  298.          /Pnn      Postions the prompt on the screen
  299.          /Cnn      Specifies color for text messages
  300.          /M[ono]   Displays color file in mono
  301.          /Tnn      Specifies delay for message display
  302.          /R        See registration incentives below
  303.  
  304.        THE PROMPT POSITION /Pnn
  305.  
  306.        When you display a screen file the internal prompt message is
  307.        located on Line 22. This is part of the boot sector, not your
  308.        screen image. You can change the position in the boot sector with
  309.        the switch /Pnn where nn is the line number you want the prompt
  310.        to appear.
  311.  
  312.        For example, if you have a small display you may not want the
  313.        prompt at the bottom of the screen. Valid lines are 1 to 25. If
  314.        you specify any other line number (0 or 26 for instance) the
  315.        prompt will be off the screen and will not display. You must
  316.        therefore supply your own in the ".BIN" file or ".TXT" file. An
  317.        example: "COLRBOOT COLRFILE.BIN /P10" will display the prompt on 
  318.        the 10th line.
  319.  
  320.        COLORFUL TEXT /Cnn
  321.  
  322.        You may specify a color for your text. The switch is /Cnn where
  323.        nn is the color's HEX number. Valid colors are 1-FF. If you
  324.        cannot remember (who does) or do not know the color numbers
  325.        simply enter COLRBOOT /C? (or simply /C). Your screen will
  326.        display the numbers. You may also display the grid with a color
  327.        attribute. For example: "COLRBOOT COLRFILE.BIN TEXTFILE /C=1E" 
  328.        will display text in yellow on a blue background.
  329.        
  330.        MONO DISPLAY /M or /MONO
  331.  
  332.        If you are distributing COLOR BOOT disks check how your display
  333.        shows in mono (on some notebooks for instance). There is a switch
  334.        for this: /MONO. This will display your screen as it would appear
  335.        to a mono user.
  336.  
  337.        The /MONO switch may be abbreviated to /M. Enter COLRBOOT /C/M to
  338.        display the color chart in mono. The /MONO switch does NOT store
  339.        your screen on the target disk in mono mode. It is stored as
  340.        color but will display mono on a mono PC.
  341.  
  342.        If you specify BLANK for the color file and a color option for
  343.        text the whole screen will be changed to the text color. For
  344.        example: COLRBOOT BLANK FILE.TXT /C1E /P0. This example positions
  345.        the prompt off the screen (/P0) so you may supply your own prompt
  346.        in FILE.TXT to display in the chosen color.
  347.  
  348.        THE TIME DELAY /Tnn
  349.  
  350.        You may specify a time that the color image will display before 
  351.        the boot prompt appears and the user has the option of pressing a 
  352.        key. The switch is /Tnn where nn is the number of seconds. The 
  353.        default is zero. The maximum is 60 seconds (one minute). If this 
  354.        is exceeded you will be told. An example: COLRBOOT FILE.BIN A: 
  355.        /T10 will cause the display to freeze for 10 seconds before the 
  356.        prompt appears on the screen.
  357.  
  358.        MORE ABOUT THE COMMAND LINE
  359.  
  360.        The COLOR BOOT command line accepts filenames, switches and the
  361.        target drive in any order. Just so long as the color file is
  362.        specified before the text file.
  363.  
  364.           This works: COLRBOOT COLRFILE /P10 TEXTFILE /C0E A:
  365.         So does this: COLRBOOT A: /P10/C0E COLRFILE TEXTFILE
  366.  
  367.        For a finale we provide these. Do not specify a drive and the
  368.        result will display on the screen.
  369.  
  370.          COLRBOOT STARCITY.BIN VIRUSES.TXT
  371.          COLRBOOT ADELAIDE.BIN ADELAIDE.TXT /P19/C1E
  372.  
  373.        ───────────────────────────────────────────────────────────────-
  374.        SECTION FOUR:
  375.        THE LAUGHING DOG - AN EXCELLENT COLOR SCREEN EDITOR
  376.        ───────────────────────────────────────────────────────────────-
  377.  
  378.        The standard PC screen is composed of 25x80 characters (2000).
  379.        Each character has a color "attribute" which is stored in memory
  380.        with the character. The attribute sets the foreground and
  381.        background colors as well as foreground brightness and a blinking
  382.        attribute. This means there are exactly 4000 bytes.
  383.  
  384.        COLRBOOT simply writes the 4000 bytes to memory. It does no
  385.        conversion such as ANSI.SYS which translates ESC "commands" into
  386.        colors and cursor positions.
  387.  
  388.        The public domain is littered with ANSI graphic displays which
  389.        you can convert into prompts. However, COLRBOOT does not
  390.        recognize an ANSI file and you must edit it and convert it to
  391.        binary. One of the best editors we have seen is the curiously
  392.        named LAUGHING DOG available as LDOG*.ZIP from many shareware
  393.        distributors and bulletin boards. (Currently LDOG114.ZIP).
  394.  
  395.        This is the BEST program for using with COLOR BOOT and all round
  396.        screen editing. It allows you to capture screens and turn them
  397.        into ".BIN" files, ANSI files and even self-displaying ".COM"
  398.        files. As well, it can provide a screen as source code in several
  399.        programming languages including BASIC, ASM, C, and PASCAL. Truly
  400.        excellent.
  401.  
  402.        COLOR BOOT users may request an UNREGISTERED copy of LDOG along
  403.        with ANSI graphics in LDOG format and tips on how to use LDOG
  404.        with COLOR BOOT.
  405.  
  406.        ───────────────────────────────────────────────────────────────-
  407.        REGISTRATION         * IMPORTANT INFORMATION *
  408.        INCENTIVES
  409.        ───────────────────────────────────────────────────────────────-
  410.  
  411.   **   | Whether you register COLRBOOT or not is entirely up to you. By 
  412.   **   | default the boot sector you make displays an UNREGISTERED 
  413.   **   | message. However, you may disable this at any time by simply 
  414.   **   | keying an /R switch on the command line when you create a 
  415.   **   | COLRBOOT disk.
  416.  
  417.   **   | COLRBOOT FILE.BIN A: /R    The /R switch disables the
  418.   **   |                            "UNREGISTERED" display
  419.  
  420.        For registration please send US$10 currency (the address is at 
  421.        the top of this file). The price includes world wide air mail.
  422.  
  423.        All questions are welcomed. Use smail, phone or Internet. You do
  424.        not have to be a registered user.
  425.  
  426.        WHEN YOU register COLOR BOOT you will receive the latest version
  427.        and extra color screens. You will also receive for evaluation 
  428.        several other unique programs I have developed over the past few 
  429.        years.
  430.  
  431.        ■ FLASHPRINT is possibly the best DOS printer driver in the world
  432.          (I can honestly say I haven't seen anything that comes close).
  433.          It lets you COMPLETELY control any printer from ANY program. It
  434.          includes downloadable fonts for LQ printers which you can
  435.          change from within a document using any word processor. You can
  436.          have thousands of printer commands to do virtually anything
  437.          your printer can do. You can customise it very easily (the
  438.          driver table is an incredibly easy-to-understand text file).
  439.          Truly comprehensive and easy printer control.
  440.  
  441.        ■ KWIKPRINT is an easy-to-use command line replacement similar to
  442.          COPY FILENAME PRN -- but with all the things COPY won't do.
  443.          Multiple filenames, number of copies, formfeeds, screen bar
  444.          showing print in progress. And a hot switch for immediate abort
  445.          which stops the printer dead! Included are a couple of other
  446.          useful printer utitilies (a hotkey which does a form feed, for
  447.          example).
  448.  
  449.        ■ KWIKPOPS uses some of the same code as COLRBOOT to make instant
  450.          popup TSR screens. You can make a popup from a plain text file
  451.          in less than 30 seconds. Or use color ".BIN" screens. The
  452.          package includes a simple but excellent screen grabber and
  453.          viewer. The screen grabber allows you to capture any ASCII
  454.          screen to use as a COLRBOOT display.
  455.  
  456.        ■ As well there's a grab bag of useful hotkey utilities, an easy-
  457.          to-use PRN2DISK program, programs to convert screen image files
  458.          to ASM, C or PASCAL data source code and more...
  459.  
  460.        Please ask if you would like the latest "shareware" version of
  461.        LDOG. This is supplied as a courtesy and requires separate 
  462.        payment to the author.
  463.  
  464.        *** END OF FILE ***
  465.